home *** CD-ROM | disk | FTP | other *** search
/ AmigActive 10 / AACD 10.iso / AACD / Sound / PlayMidi / PlayMidi.readme next >
Text File  |  1999-12-27  |  6KB  |  133 lines
  1. Short:    V1.0b Plays MIDI Files via GMPlay & cli.datatype
  2. Uploader: dbusse@debitel.net (Dirk Busse)
  3. Author:   dbusse@debitel.net (Dirk Busse)
  4. Type:     util/dtype
  5. Requires: GMPlay and cli.datatype
  6.  
  7.  
  8. Pre-History & Description:
  9.    Did you ever wonder why IBrowse never plays Midi background sounds?
  10.    You could setup a external viewer audio/midi
  11.    with the command  $GMDIR/GMPlay
  12.    and the arguments <>CON:100/80/500/120/GMPlay "%f" V=400 B=2 PRI=21
  13.    If you load a Midi file via the URL, IBrowse plays it. But when you load
  14.    a web page with a Midi background sound, IBrowse doesn't plays it.
  15.    The reason is: IBrowse loads background sound only via datatypes.
  16.    So my idee was to write a datatype which forwards the file to GMplay.
  17.    My knowledges of programming datatypes and of programming in C are nearly
  18.    zero. I didn't found an example datatype in assembler, but I found the
  19.    cli.datatype.
  20.    The first solution (starting directly GMPlay via cli.datatype) wasn't
  21.    very well.
  22.    The second solution (starting GMplay via a shell script via cli.datatype)
  23.    was a little better. But it doen't works "clean".
  24.    So I wrote a little assembler program "PlayMidi", which gives a little
  25.    note to the caller (for example MultiView), breaks the actually GMPlay
  26.    (you couldn't start GMPlay twice) and runs GMPlay with the new file.
  27.  
  28. Installation:
  29.    - You need a successfully installed GMPlay.
  30.      (Aminet:mus/midi/GMPlay13.lha)
  31.    - You need a successfully installed cli.datatype.
  32.      (AMinet:util/dtype/cli_dtc.lha)
  33.      For using with AMIGA OS 3.5 you need the latest cli.datatypes V39.7
  34.      which is included in this archive.
  35.    - copy "c/PlayMidi" somewhere in your path (for example in c:)
  36.    - copy "datatypes/MIDI" and "datatypes/XPKMIDI" to devs:datatypes
  37.    - create a env variable GMDIR with the path of GMPlay.
  38.      for example with:
  39.      setenv envarc:GMDIR "DH0:MIDI/GMPlay"
  40.    - create a env variable PlayMidiGMopts with your options which you want
  41.      to use for GMPlay.
  42.      for example with:
  43.   setenv envarc:PlayMidiGMopts ">CON:100/80/510/120/GMPlay V=400 B=2 PRI=21"
  44.      (You could use there all GMPlay options. Now you could simple use
  45.       PlayMidi instead of GMPlay for playing your Midi files.)
  46.    - add to the file envarc:datatypes/cli.prefs the following lines:
  47.  
  48.      MIDI     COMMAND=PlayMidi "%s"
  49.      XPKMIDI  COMMAND=PlayMidi "%s"
  50.  
  51.    - That's all! Now IBrowse should play Midi background sounds!
  52.      Now also every datatype viewer like MultiView should play midi files.
  53.  
  54.  
  55.    (- Setting up IBrowse External Viewers for Midi support:
  56.       Type:      audio/midi     and    audio/x-midi
  57.       Mime:      midi mid kar
  58.       Action:    Ext. viewer
  59.       Viewer:    PlayMidi
  60.       Arguments: "%f"                                       )
  61.  
  62.  
  63.  
  64. Example envarc-files and the source code of PlayMidi is also in the archive.
  65.  
  66.  
  67. Author:
  68.    Dirk Busse
  69.    Kropsburgstraße 8
  70.    D-67141 Neuhofen
  71.    Germany
  72.    <dbusse@debitel.net>
  73.    <dbusse@germanynet.de>
  74.  
  75.  
  76. Questions&Answers:
  77.  
  78.    Q: Where are pages on the Internet with Midi background sounds?
  79.    A: For example at:
  80.       http://www.elaborate-bytes.com/deutsch/firma/index.htm
  81.       http://www.brenner-sievritts.com/hauptmenu.htm
  82.       http://www.dlrg.de/Gliederung/Rheinland-Pfalz/Vorderpfalz/Ludwigshafen-Oggersheim/index.html
  83.  
  84.    Q: IBrowse doesn't plays Midi-Files from the GMPlay archive as
  85.       background sound.
  86.    A: IBrowse plays only background sounds with the datatype class sound.
  87.       The Midi-Files from the GMPlay archive are xpk-packed. Xpk isn't a
  88.       sound datatype class.
  89.       But this shouldn't be a problem. If you open the Midi file directly,
  90.       IBrowse should play it. And as background sound you must not use
  91.       packed Midi files. Because xpk isn't a standard in the Internet. It's
  92.       only a standard on the Amiga.
  93.       With devs:Datatypes/XPKMIDI IBrowse will also play xpk packed midi
  94.       files as background sound. But don't use xpk packed midi files on
  95.       webpages, because xpk is only on the AMIGA a standard.
  96.  
  97.    Q: IBrowse 2.1 doesn't plays background sounds  :-(  :-(  :-(  :-(
  98.    A: I don't know why. Maybe the Authors of IBrowse knows the answer.
  99.  
  100.    Q: MultiView crashes with an GURU on AMIGA OS 3.5.
  101.    A: Please use the recompiled cli.datatype V39.7. This should fix this
  102.       problem.
  103.       (The cli.datatype V39.7 archive is included in this PlayMidi archive.)
  104.  
  105.    If you have some other questions or problems, you could send me a EMail
  106.    or letter.
  107.  
  108.  
  109. History:
  110.    1.0  (07.May 1999)
  111.         - First version.
  112.    1.0a (04.Dec 1999)
  113.         - The Datatype doesn't work under AMIGA OS 3.5
  114.           To fix this Problem you have to do the following:
  115.           **** Lines killed, because the reason wasn't PlayMidi. ****
  116.           **** The problem was cli.datatype V39.6                ****
  117.    1.0b (27.Dec 1999)
  118.         - The reason for the problem with AMIGA OS3.5 is not PlayMidi.
  119.           It's the cli.datatype V39.6. Also viewing lha files crashes
  120.           under OS3.5. 
  121.           I have recompiled the cli.datatype (now V39.7) which now works
  122.           also under AMIGA OS3.5.
  123.           Please use this cli.datatype V39.7.
  124.         - Added the cli.datatype V39.7 archive, which now works under
  125.           AMIGA OS3.5.
  126.         - Playing xpk packed Midi files with MultiView under AMIGA OS3.5
  127.           crashes, when they are unpacked by the xpk.datatype V39.1.
  128.           But GMPlay could decrunch xpk packed Midi files by itself.
  129.           Therefor I created a second datatypes descriptor "XPKMIDI" which
  130.           doesn't use the xpk.datatype for midi files.
  131.         - Added example envarc:Datatypes/cli.prefs file
  132.  
  133.